Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRWrapAndConstrain

You can use the QTVRWrapAndConstrain function to preflight a change in the viewing or control characteristics of an object or panoramic node.

OSErr QTVRWrapAndConstrain (
                     QTVRInstance qtvr,
                     short kind,
                     float value,
                     float *result);
qtvr
An instance of a QuickTime VR movie.
kind
A constraint type. See "Constraint Types" for a description of the available constraint types.
value
The desired value of the specified viewing characteristic.
result
On exit, the value to which the specified viewing characteristic would be set if it were changed.
function result
A result code.

DESCRIPTION

The QTVRWrapAndConstrain function returns, in the result parameter, the constrained or wrapped value that would result from setting the viewing or control characteristic specified by the kind parameter to the value specified by the value parameter. For example, if the kind parameter is set to kQTVRPan , then QTVRWrapAndConstrain returns the value that would result from calling the QTVRSetPanAngle function with its panAngle parameter set to value . Similarly, you can use QTVRWrapAndConstrain to find the current bounds of the view center. QTVRWrapAndConstrain takes into account the current constraints and wrapping modes of the node specified by the qtvr parameter.

QTVRWrapAndConstrain does not change the current view or other settings of the specified object or panorama.

© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |